home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / relnotes / dmedia_eoe / ch15.z / ch15
Text File  |  2001-04-17  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        15.  _D_i_g_i_t_a_l__M_e_d_i_a__D_S_O_'_s
  9.  
  10.  
  11.        A number of shared execution libraries (DSO's) are included
  12.        in the _d_m_e_d_i_a__e_o_e images. The directory /usr/lib contains
  13.        versions of these DSO's for use by o32 applications, and the
  14.        directory /usr/lib32 contains versions for use by n32
  15.        applications. The subsystems _d_m_e_d_i_a__e_o_e._s_w._l_i_b and
  16.        _d_m_e_d_i_a__e_o_e._s_w_3_2._l_i_b install the o32 and n32 versions of the
  17.        base DSO's respectively. The subsystems
  18.        _d_m_e_d_i_a__e_o_e._s_w._p_l_u_g_i_n_s and _d_m_e_d_i_a__e_o_e._s_w_3_2._p_l_u_g_i_n_s install
  19.        the o32 and n32 versions of special-effects plug-in modules.
  20.  
  21.        This section briefly describes the functions of the
  22.        different digital media DSO's.
  23.  
  24.  
  25.        15.1  _A_u_d_i_o__L_i_b_r_a_r_y
  26.  
  27.        The Audio Library provides an application software interface
  28.        to the audio I/O device capabilities of the system.
  29.  
  30.  
  31.        15.1.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  32.  
  33.           +o In IRIX 6.4, and starting with IRIX 6.3, the Audio
  34.             Library is now a DSO rather than a static library. It
  35.             is installed as /usr/{lib,lib32,lib64}/libaudio.so.1.
  36.             Applications which were linked with libaudio.a in
  37.             previous releases will continue to operate properly in
  38.             IRIX 6.4.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.        15.2  _V_i_d_e_o__L_i_b_r_a_r_y
  45.  
  46.        The Video Library provides an application software interface
  47.        to the video I/O device capabilities of the system, as well
  48.        as access to special video hardware paths such as video to
  49.        screen or screen capture to memory on some systems which
  50.        have these features. The Video Library DSO is installed as
  51.        /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_v_l._s_o.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        15.3  _D_i_g_i_t_a_l__M_e_d_i_a__L_i_b_r_a_r_y__a_n_d__I_m_a_g_e_/_A_u_d_i_o__C_o_n_v_e_r_t_e_r_s
  75.  
  76.        The Digital Media Library provides core functionality for
  77.        digital media applications. Functionality in IRIX 6.4
  78.        includes:
  79.  
  80.           +o IIIImmmmaaaaggggeeee ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn mmmmaaaannnnaaaaggggeeeemmmmeeeennnntttt: a software framework for
  81.             managing software image codecs and realtime memory-to-
  82.             memory image codecs which rely on hardware
  83.             acceleration.
  84.  
  85.           +o AAAAuuuuddddiiiioooo ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn mmmmaaaannnnaaaaggggeeeemmmmeeeennnntttt: a software framework for
  86.             managing audio data conversion including
  87.             compression/decompression, sampling rate conversion,
  88.             sample data format conversion, and channel matrix
  89.             conversion.
  90.  
  91.           +o DDDDiiiiggggiiiittttaaaallll mmmmeeeeddddiiiiaaaa bbbbuuuuffffffffeeeerrrr ssssyyyysssstttteeeemmmm: a software framework which
  92.             allows memory buffers containing compressed or
  93.             uncompressed image data to be moved with copying
  94.             between various subsystems including video I/O ports,
  95.             software or realtime memory-to-memory image
  96.             compressors, and OpenGL.
  97.  
  98.           +o SSSSooooffffttttwwwwaaaarrrreeee ccccoooolllloooorrrr ssssppppaaaacccceeee ccccoooonnnnvvvveeeerrrrssssiiiioooonnnn: the Digital Media
  99.             Library includes optimized code for performing high
  100.             quality color space conversion in software.
  101.  
  102.           +o DDDDiiiiggggiiiittttaaaallll mmmmeeeeddddiiiiaaaa nnnneeeettttwwwwoooorrrrkkkkiiiinnnngggg: a network-independent
  103.             framework which allows the interchange of _D_M_b_u_f_f_e_r_s
  104.             between processes, whether on the same machine or on
  105.             machines connected by a network.
  106.  
  107.  
  108.        15.3.1  _D_i_g_i_t_a_l__M_e_d_i_a__L_i_b_r_a_r_y__D_S_O_'_s  The Digital Media
  109.        Library is composed of the following DSO's:
  110.  
  111.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_d_m_e_d_i_a._s_o: The Digital Media
  112.             Library.
  113.  
  114.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_d_m_e_d_i_a/_i_m_a_g_e_c_o_n_v_e_r_t_e_r_s/*._s_o: Image
  115.             converter modules for software image codecs and
  116.             realtime memory-to-memory hardware-accelerated codecs.
  117.             These modules are loaded at runtime by the Digital
  118.             Media Library when required by an application. They are
  119.             not loaded directly by applications.
  120.  
  121.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_d_m_e_d_i_a/_a_u_d_i_o_c_o_n_v_e_r_t_e_r_s/*._s_o: Audio
  122.             converter modules for audio compression/decompression,
  123.             audio sampling rate conversion, and audio data format
  124.             and channel matrix conversion. These modules are loaded
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.             at runtime by the Digital Media Library when required
  141.             by an application. They are not loaded directly by
  142.             applications.
  143.  
  144.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_c_l._s_o: The "old" Compression
  145.             Library. This library provides the developer interface
  146.             and software framework for several image codecs and a
  147.             few audio codecs in IRIX 6.2 and earlier releases. The
  148.             full IRIX 6.2 functionality is supported in IRIX 6.4
  149.             and future releases for backward compatibility with
  150.             existing applications. Low level image codec modules in
  151.             the "imageconverters" directory are now shared by
  152.             libdmedia.so and libcl.so.
  153.  
  154.           +o /_u_s_r/{_l_i_b, _l_i_b_3_2}/_l_i_b_a_w_a_r_e_a_u_d_i_o._s_o: Aware,Inc audio
  155.             compression framework DSO. There are no routines in
  156.             this DSO that are visible to developers. This DSO is
  157.             used internally by libcl.so for interfacing to the MPEG
  158.             and Aware, Inc MultiRate codecs only.
  159.  
  160.           +o /_u_s_r/{_l_i_b, _l_i_b_3_2}/_l_i_b_a_u_d_i_o_u_t_i_l._s_o: In earlier releases,
  161.             this library included audio conversion and compression
  162.             operations. In IRIX 6.3 and IRIX 6.4, audio conversion
  163.             operations have all been centralized in the Digital
  164.             Media Library, libdmedia.so. As a result,
  165.             libaudioutil.so is now a symlink to libdmedia.so.
  166.  
  167.           +o /usr/{lib,lib32}/libdmnet.so: _T_h_i_s _l_i_b_r_a_r_y _p_r_o_v_i_d_e_s _a
  168.             _s_t_a_n_d_a_r_d _A_P_I _f_o_r _m_o_v_i_n_g _D_i_g_i_t_a_l _M_e_d_i_a _b_u_f_f_e_r_s _b_e_t_w_e_e_n
  169.             _a_p_p_l_i_c_a_t_i_o_n_s _o_n _t_h_e _s_a_m_e _m_a_c_h_i_n_e _o_r _a_p_p_l_i_c_a_t_i_o_n_s
  170.             _s_e_p_a_r_a_t_e_d _b_y _a _n_e_t_w_o_r_k.
  171.  
  172.  
  173.        _1_5._3._2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  174.  
  175.           +o IRIX 6.5.12 added support for decompressing Microsoft
  176.             RLE. This will only work with data which was previously
  177.             generated using Quicktime(*).
  178.  
  179.           +o The DMNet API for Digital Media Networking is an
  180.             addition to IRIX 6.5.  It provides a standard API on
  181.             all IRIX platforms for interchanging Digital Media
  182.             buffers between processes, whether they are on the same
  183.             machine or separated by a network.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        15.4  _M_o_v_i_e__L_i_b_r_a_r_y
  207.  
  208.        The Movie Library provides core library software for
  209.        reading, writing, editing, and playing back standard movie
  210.        file formats (QuickTime(*), AVI, MPEG-1 video/systems
  211.        bitstreams, SGI Movie).
  212.  
  213.        Starting with IRIX 6.3, the Movie Library is now composed of
  214.        a set of DSO's rather than a single static library.
  215.        Applications which were linked with libmovie.a in previous
  216.        releases will continue to operate properly in IRIX 6.4.
  217.  
  218.  
  219.        15.4.1  _M_o_v_i_e__L_i_b_r_a_r_y__D_S_O_'_s  The Movie Library is composed
  220.        of the following DSO's:
  221.  
  222.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_m_o_v_i_e_f_i_l_e._s_o: The Movie File
  223.             Library. This DSO implements file read, write, edit
  224.             support. It is a high-level library which builds on top
  225.             of the image compression/conversion and audio
  226.             compression/conversion functions in the core Digital
  227.             Media Library.
  228.  
  229.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_m_o_v_i_e_p_l_a_y._s_o: The Movie Playback
  230.             Library. This DSO provides high level playback and
  231.             transport control functions to applications.  It is
  232.             built on top of the "lower level" functions provided by
  233.             the Movie File Library, and uses OpenGL and the Audio
  234.             Library for rendering synchronized audio/image output.
  235.  
  236.           +o /_u_s_r/{_l_i_b,_l_i_b_3_2}/_d_m_e_d_i_a/_m_o_v_i_e/*._s_o: Movie display ports
  237.             and rendering modules loaded internally by the playback
  238.             engine, libmovieplay.so, as required at runtime.
  239.             Applications do not load these modules directly.
  240.  
  241.           +o /_u_s_r/{_l_i_b, _l_i_b_3_2}/{_l_i_b_m_o_v_i_e._s_o,_l_i_b_m_o_v_i_e_G_L._s_o}: These
  242.             are now "stub" DSO's which simply make available all
  243.             the public symbols from libmovieplay.so and
  244.             libmoviefile.so.  They exist only to provide backward
  245.             compatibility with link lines for applications that
  246.             were previously built using "-lmovie" or "-lmovieGL".
  247.             In IRIX 6.4, it is strongly recommended that developers
  248.             explicitly link with "-lmovieplay -lmoviefile" or just
  249.             "-lmoviefile" as appropriate.
  250.  
  251.  
  252.        15.4.2  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  253.  
  254.           +o IRIX 6.5.12 adds support for reading of 1, 2, 4, 8, 16
  255.             and 24 bit uncompressed AVI files. Originally only 32
  256.             bit uncompressed AVI files were supported.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.           +o IRIX 6.5.12 adds support for reading of Microsoft RLE
  273.             compressed AVI files.
  274.  
  275.           +o IRIX 6.5.12 adds support to allow reading of compressed
  276.             header Quicktime(*) movie files.
  277.  
  278.           +o As of IRIX 6.3 the Movie Library is no longer
  279.             statically linked into applications. It is now composed
  280.             of two high-level DSO's, libmoviefile.so and
  281.             libmovieplay.so, which contain the public movie file
  282.             and playback API's, as well as several of rendering and
  283.             playback modules loaded internally by libmovieplay.so.
  284.  
  285.  
  286.        15.4.3  _B_u_g__F_i_x_e_s
  287.             Bug 610006: An internal Movie Library data structure
  288.             and the algorithm that managed its growth could
  289.             fragment the application memory heap and cause poor
  290.             performance during movie capture. The data structure
  291.             and algorithm have been corrected in Irix 6.5.1m.
  292.  
  293.           +o
  294.  
  295.  
  296.  
  297.        15.5  _A_u_d_i_o__F_i_l_e__L_i_b_r_a_r_y
  298.  
  299.        The Audio File Library, /_u_s_r/{_l_i_b,_l_i_b_3_2}/_l_i_b_a_u_d_i_o_f_i_l_e._s_o,
  300.        provides core library software for reading and writing a
  301.        variety of sound file formats (see the "Supported Media File
  302.        Formats" chapter of these release notes).
  303.  
  304.        The Audio File Library is a high-level library that makes
  305.        use of the lower-level audio compression and conversion
  306.        functions offered by the core Digital Media Library.
  307.  
  308.  
  309.        15.5.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  310.  
  311.           +o Addition of support for 32- and 64-bit floating point
  312.             AIFF-C files.
  313.  
  314.           +o Addition of support for AIFF-C files which use IMA4:1
  315.             compression, and full compliance with Apple, Inc.
  316.             AIFF-C compression specifications.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        15.6  _M_I_D_I__L_i_b_r_a_r_y
  339.  
  340.  
  341.        The MIDI Library, /_u_s_r/{_l_i_b, _l_i_b_3_2}/_l_i_b_m_d._s_o, provides an
  342.        application interface to the IRIX MIDI I/O system built.
  343.        This system offers support for timestamped MIDI I/O through
  344.        serial ports, and for delivery of interprocess MIDI events
  345.        (eg, play back a MIDI sound file using _I_S_o_u_n_d_P_l_a_y_e_r(_1) and
  346.        trigger music synthesis on a second process, the software
  347.        MIDI synthesizer).
  348.  
  349.  
  350.        15.6.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  351.  
  352.           +o The MIDI Library has not changed since IRIX 6.2.
  353.  
  354.  
  355.  
  356.        15.6.2  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  357.  
  358.           +o In IRIX 6.4, MIDI I/O through the serial ports is fully
  359.             functional for the Onyx2 workstation and also for
  360.             Origin2000 with the optional base audio option.  In
  361.             IRIX 6.3, MIDI I/O through the serial ports is not
  362.             functional on the O2 workstation.  It is our hope that
  363.             we will be able to provide this functionality for IRIX
  364.             6.3 in the form of a patch.
  365.  
  366.  
  367.  
  368.  
  369.  
  370.        (*) QuickTime is a registered trademark of Apple Computer,
  371.        Inc.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.